home *** CD-ROM | disk | FTP | other *** search
/ EuroCD 3 / EuroCD 3.iso / Communication / Citadel_BBS / Util / Citadel_2ndfmt.lha / 2ndfmt.doc next >
Encoding:
Text File  |  1997-07-28  |  1.6 KB  |  56 lines
  1.  
  2.  2NDFMT
  3.  
  4.  This utility takes a raw domain information file and translates it into
  5.  the form that Citadel uses for routing.
  6.  
  7.  
  8.   2NDFMT <input file> <output file>
  9.  
  10.   input file is usually NODES0.RAW, a file you would get from C86 Test
  11.              system.
  12.  
  13.   Output File should be NODES0.FST, again you would normally get this
  14.               file with the other one.
  15.  
  16.   This data is used for routing, if you mess up, you can cause net
  17.   confusion so be sure of you changes.
  18.  
  19.  
  20. Initial Format
  21.  
  22.  The initial format of the input file is a collection of "domain" records.
  23.  Each record begins with the line ".domain <domainname>".  Each following
  24.  non-blank line designates a system within that domain until EOF or the
  25.  next line of format ".domain <domainname>".
  26.  
  27.  Each line designating a system is generically:
  28.  
  29.  <system name>[:<real name>]
  30.  
  31.  Real name is only of use when defining a common alias for a system.  For
  32.  example,
  33.  
  34.  Test System : C-86 Test System
  35.  
  36.  
  37. Final Format
  38.  
  39.  Each line will look generically like this:
  40.  
  41.  [flag byte]<system><tab><domain>[<tab><real name>]<\n>
  42.  
  43.  In English, an entry is composed of an optional flag byte, followed by
  44.  the system name and its domain separated by a TAB, optionally followed
  45.  by the real system name (again separated by a TAB) if the name is an
  46.  alias for someone else.
  47.  
  48.  The optional flag byte is distinguishable by its value, which will be
  49.  non-printing (!isprint(x)).  Flag byte values will be defined as needed.
  50.  Currently, the list of flag values (see 2ndFmt.h, too) is limited to
  51.  this:
  52.  
  53.  DUPLICATE - 0x01, this means there is more than one system by this name
  54.  in the list.  Makes processing a bit easier by main program.
  55.  
  56.